Creating Hyperlinks in DITA Source Documents

You will have to use DITA elements to create links in your documents so that ePublisher can create links to other topics or files in the online help output of your choice.

  1. Identify your link type, as it will determine the markup that is required.

  2. For a hyperlink that is going the same file create the following markup:

    <xref href="\#yourtopicID">Your xref link text</xref>

  3. For a hyperlink that is going to a different file create the following markup:

    <xref href="file.xml\#yourtopicID">Your xref link text</xref>

  4. For a hyperlink that is going to a PDF create the following markup:

    <xref format="PDF" href="sample.PDF">Your xref link text</xref>

Last modified date: 08/12/2026